home *** CD-ROM | disk | FTP | other *** search
/ Network PC / Network PC.iso / amiga utilities / graphics / conversion / psx_imagetools / docs / praw2tga.txt < prev    next >
Encoding:
Text File  |  1997-11-21  |  6.9 KB  |  253 lines
  1.  
  2. 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8
  3. PRAW2TGA
  4.  
  5. by
  6.  
  7. STRUCTURe 
  8.  
  9. of
  10.  
  11. The Immaculate Hood
  12. 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8
  13.  
  14.  
  15.                      8 8 8 8 8 8 8 8 8 8 8 8 8 8 8
  16.                         Exclusive Distribution
  17.  
  18.                              BamBam on the Net
  19.  
  20.                   www.universal.nl/users/magic/sonypsx.htm
  21.                      8 8 8 8 8 8 8 8 8 8 8 8 8 8 8
  22.  
  23. 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8
  24. Special Thanks
  25.  
  26. to
  27.  
  28. Hido-Genshi
  29. 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8
  30.  
  31.  
  32.  
  33.  
  34.          THIS PROGRAM IS FREEWARE!! PASS IT ON!
  35.  
  36.  
  37.         Requests and bug reports to: struct@netcom.com
  38.  
  39.           @@@Join the inFREEmation Network@@@
  40.  
  41.  
  42.  
  43. --
  44. BASIC INFORMATION
  45. --
  46.  
  47.    PRAW2TGA converts PSX raw image files to Targa format.  Currently, 
  48. only 16 and 24 bit files are supported, but this should cover about 75% 
  49. of what's out there (along with TIM2TGA and TIM2BMP).  
  50.  
  51. Syntax:
  52.  
  53.    PRAW2TGA {-owhd} infile outfile
  54.  
  55.     infile = name of raw, uncompressed file
  56.     outfile = name of output targa file
  57.     
  58.     options (all are optional and formatted like -o=#####)
  59.  
  60.     -o   Sets the offset within the raw file for the image start.
  61.         (example -o=1024)
  62.     -w   Sets the image width.
  63.         (example -w=320 makes the image 320 pixels wide)
  64.     -h   Sets the image height.
  65.         (example -h=480 makes the image 480 pixels tall)
  66.     -d   Sets the bit-depth.
  67.         (example -d=16 signifies a 16 bit image)
  68.  
  69.        If not specified, each of the options will try to be auto-
  70.     detected, except for offset which defaults to '0'.  This is not
  71.     always sucessful but works a good percentage of the time.  The
  72.     more values that you give it to start with the more accurate the
  73.     automatic values will be.  See trouble-shooting for more info.
  74.  
  75.        The options and file names can occur in any order, but the
  76.     'infile' name must appear before the 'outfile' name.
  77.  
  78.  
  79.  
  80.  
  81.  
  82. --
  83. OTHER TOOLS YOU SHOULD HAVE TO USE THIS PROGRAM
  84. --
  85.  
  86.  
  87.    If I can I will try to include any other programs that you need to use 
  88. this program.  I may not be able to so here's what I use:
  89.  
  90.  
  91.    Sector Editor/Hex Viewer -
  92.  
  93.     On the Amiga I use FileX.  It's the BEST hex editor I've ever seen.
  94.       I'll try to include it with the archive.  On the PC I know that Norton
  95.       Utilities has a good editor.  I will try to include a program called
  96.       'list' that is a hex viewer.  You probably already have one anyway ;)
  97.  
  98.    Base Converter -
  99.     
  100.     Something to convert hex addresses given by FileX (hex editor)
  101.       to decimal numbers (base 10)  (i.e. 0xFF = 255).  If your hex
  102.       viewer gives offsets in decimal then you don't need this.  If you
  103.       can do the conversions in your head I will worship you ;)  On the
  104.       Amiga I use a program called 'Calc' which is a multi-base calculator.
  105.  
  106.    Image Editor/Cropper -
  107.  
  108.     Something like ImageFX, ADPro, Photoshop, Painter, etc...
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. --
  116. TUTORIAL (sort of)
  117. --
  118.  
  119.  
  120. :Finding RAW graphcs data on PSX discs:
  121.  
  122.    Look for files that have extensions like PIX, DAT, RAW, IMG, PIC, etc... 
  123. Anything that looks like 'Image' or 'Picture' as an extension.   Another 
  124. good way is looking at the file-size.  See the 'TABLE.TXT' file.
  125.    Look for large '.EXE' files.  Many times at the end of the file there 
  126. will be a title screen.
  127.    
  128.  
  129. :Identifying Graphics Data:
  130.  
  131.    Drop the program into your hex viewer and take a look at it.  Look for 
  132. typical graphics data.  If you are unfamilliar with what typical image 
  133. files look like in a hex editor, load up a 16-bit and a 24-bit targa file 
  134. and take a look at the patterns.  You should see a brief bit of garbage at 
  135. the top of the targa file (this is the header) followed by 2 or 3 byte 
  136. patterns.
  137.    If you are looking at an 'EXE' file start at the end and look backwards.  
  138. The mass amounts of '00' at the start are part of the header.
  139.  
  140.  
  141. :Identifying Option Info:
  142.  
  143.    You can try to let PRAW2TGA figure out for its self the depth and width 
  144. and height, but you must give it the offset if there is one.  If you can 
  145. give it the depth it will also have a much easier time.  The Auto-detect 
  146. AI routines work about 75% of the time on 'typical' situation raw image 
  147. files.  At a minimum they should give you a bise to start working from.
  148.    Look for the first offset where the patterns start.  This may be right 
  149. at the top of the file (which means the offset would be '0') or it may 
  150. be in some amount.  Try to pick a place that looks right and use this 
  151. as your starting place.  You can always fine-tune it later.
  152.    To figure out what bit depth the image is look to see if the patterns 
  153. are two bytes or three bytes long.  If they are two then it is 16-bit.  If 
  154. they are three it is 24-bit.  PRAW2TGA can usually figure this out on its 
  155. own under typical conditions, but I found some tricky ones that it 
  156. missed (esp. on Loaded).  It's safe to say that 99% of the time it will 
  157. be 16-bit and not 24-bit.  If you are unsure and PRAW2TGA gives you an error 
  158. auto-detecting depth start with -d=16.
  159.  
  160.  
  161.  
  162. :RUN PRAW2TGA:
  163.  
  164.   Run the progam and see what you get.  You will find that you use settings
  165. like 'PRAW2TGA -o=0 -w=320 -h=240 -d=16 title.pix title.tga' frequently.
  166.  
  167.  
  168.  
  169.  
  170.  
  171. :TROUBLE-SHOOTING AND FINE-TUNING RESULTS:
  172.  
  173.  
  174. P: Edges of image are in the middle and the middle is on the edge:
  175.  
  176.     000000000000000000
  177.     XX0000000000000000
  178.     XXX00000000000000X
  179.     XXXX000000000000XX
  180.     XXX00000000000000X
  181.     XX0000000000000000
  182.     000000000000000000
  183.  
  184.       (Your example may not be as extreme)
  185.  
  186. S: Adjust the offset (-o=) option.
  187.  
  188.  
  189. P: Image is offset to the right or left:
  190. S: Same as above
  191.  
  192. P: Image is Skewed:
  193.  
  194.     000000000000000000
  195.     000XXXXXXX00000000
  196.     0000XXXXXXX0000000
  197.     00000XXXXXXX000000
  198.     000000XXXXXXX00000
  199.     0000000XXXXXXX0000
  200.     000000000000000000
  201.  
  202. S: Adjust the width (-w=) option.
  203.  
  204. P: Top of image is cut off.
  205. S2: There is another file that contains the second half of the image.
  206.  
  207. P: The Bottom of the file is cut off.
  208. S1: Adjust the offset*
  209. S2: Adjust the height*
  210. S3: There is another file that contains the first half of the image.
  211.  
  212. *PSX images are stored so that the last line of the file is the first line 
  213. on the screen.  If the bottom is cut off either make the offset smaller of 
  214. the height larger.   It's always better to get a little extra garbage and 
  215. crop the image.
  216.  
  217.  
  218. P: Image is there but colors are bonkers and there is/isn't a slight skew.
  219. S: Increase the offset by a small amount.  You may be starting in PRAW2TGA 
  220.    in the middle of a pixel.
  221.  
  222. P: I can see something but it's all messed up.
  223. S: Play with the Width.  Try using VERY small pixel values like 32 or 16.  
  224.    I've found some images that are long strips of icons. (Resident Evil)
  225.  
  226. P: There's garbage at the top of the screen.
  227. S: Decrease the Height (-h=) value.
  228.  
  229. P: There's garbage at the bottom of the screen.
  230. S: Increase the offset (-o=) value.
  231.  
  232.  
  233.  
  234.  
  235. !!!HINT HINT HINT!!!!
  236.  
  237. There's a REALLY nice picture of Jill on the Resident Evil Disc... :)
  238.  
  239.  
  240.  
  241. :SPECIAL NOTE:
  242.  
  243.   If you have any suggestions for utils, please e-mail them to me.  If 
  244. any1 finds a 24-bit image file PLEASE send it to me.  I am pretty sure 
  245. that the colors on a 24 bit file will not translate correctly, but the 
  246. code's there and I just need an example to test to make sure it works 
  247. right :)
  248.  
  249. struct@netcom.com
  250.  
  251.  
  252. REMEMBER: Shop smart. Shop S-Mart.
  253.